home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_nn-tk.idb / usr / freeware / lib / nn / help / help.nn-tk-kill.z / help.nn-tk-kill
Encoding:
Text File  |  1999-04-16  |  5.1 KB  |  137 lines
  1.             Kill or Select
  2.  
  3. The main "Kill or Select" panel lists the kill file, this is a set of 
  4. rules for automatically selecting or killing articles. The Delete 
  5. button removes a selected iteem and Add allows the creation of a new item.
  6.  
  7. Selecting a line brings up a second panel which decodes the item and allows
  8. the fields to be edited. The important fields are the top button which
  9. determines if it is kill or select and the Group entry which can limit
  10. the item to a particular group or set of groups. At the bottom is a
  11. rule that determine if the article is matched, the entry is the
  12. string used in the rule and the button to the right of it is type of 
  13. test. The and... and or... buttons add extra tests that are ANDed
  14. or ORed with the first one.
  15.  
  16. THE FORMAT OF THE KILL FILE
  17.       The kill file consists of one line for each entry.   Empty
  18.       lines  and  lines starting with a # character are ignored.
  19.       nn automatically places a # character in the  first  posi-
  20.       tion  of  expired  entries when it compiles the kill file.
  21.       You can then edit the kill file manually from time to time
  22.       to clean out these entries.
  23.  
  24.       Each line has the following format
  25.           [expire time :] [group name] : flags : string [: string]...
  26.  
  27.       Permanent  entries  have no expire time (in which case the
  28.       colon is omitted as well!).  Otherwise,  the  expire  time
  29.       defines the time (as a time_t value) when the entry should
  30.       be expired.
  31.  
  32.       The group name field can have three forms:
  33.  
  34.       news.group.name
  35.             If it is the name of  a  single  news  group  (e.g.
  36.             comp.unix), the entry applies to that group only.
  37.  
  38.       /regular expression
  39.             If it starts with a slash `/' followed by a regular
  40.             expression (e.g. /^news\..*), the entry applies  to
  41.             all  groups  whose  name are matched by the regular
  42.             expression.
  43.  
  44.       empty  An empty group field will apply the  entry  to  all
  45.             groups.
  46.  
  47.       The  flags  field  consists  of a list of characters which
  48.       identifies the type of entry, and  the  interpretation  of
  49.       each string field.  When used, the flag characters must be
  50.       used in the order in which they are described below:
  51.  
  52.       ~    (optional)
  53.             When this flag is present on any of the entries for
  54.             a  specific  group, it causes all entries which are
  55.             not auto-selected to be killed.  This is  a  simple
  56.             way  to  say:  I'm interested in this and that, but
  57.             nothing else.
  58.  
  59.       +    or ! (optional)
  60.             Specify an auto-select + or an auto-kill  !  entry,
  61.             respectively.   If neither are used, the article is
  62.             neither selected nor killed which is useful in com-
  63.             bination with the `~' flag.
  64.  
  65.       > (optional)
  66.             When  used  with a subject (flag s), the kill entry
  67.             only matches follow-ups to that subject (i.e. where
  68.             the  Subject:  line starts with Re:).  For example,
  69.             to kill all "Re:"'s in rec.humor use the  following
  70.             kill entry: rec.humor:!>s/:.
  71.  
  72.       < (optional)
  73.             When  used  with a subject (flag s), the kill entry
  74.             only matches base articles with that subject  (i.e.
  75.             where  the  Subject: line does not start with Re:).
  76.             For example, to kill all articles asking  for  help
  77.             (but  not follow-ups) in the tex group, add this to
  78.             your kill file:
  79.                 comp.text.tex:!s</:^HELP
  80.  
  81.       One of nsfcClLa  (mandatory)
  82.  
  83.             Specify what the string applies to:
  84.  
  85.             n      Matches part of the name of  the  sender  of
  86.                  the article
  87.  
  88.             s      Matches part of he subject of the article
  89.  
  90.             f      Matches  part  of  the full from line of the
  91.                  article
  92.  
  93.             c      If the article is crossposted to less than N
  94.                  groups
  95.  
  96.             C      If the article is crossposted to more than N
  97.                  groups
  98.  
  99.             l      If the article is less than N lines
  100.  
  101.             L      If the article is more than N lines
  102.  
  103.             a      The string is ignored (but must be present),
  104.                  and  the  entry  applies  to articles with a
  105.                  non-empty References: line.
  106.  
  107.  
  108.       / (optional)
  109.             Specifies that the corresponding string is a  regu-
  110.             lar  expression  which  the  sender  or  subject is
  111.             matched against.  If not specified, a simple string
  112.             match is performed using the given string.
  113.  
  114.       = (optional)
  115.             Specifies  that  the match against the name or sub-
  116.             ject is case sensitive.  Furthermore, when  regular
  117.             expression  matching  is not used, the name or sub-
  118.             ject must be of the same length of  the  string  to
  119.             match.   Otherwise, the match will be case insensi-
  120.             tive, and a string may occur anywhere in  the  name
  121.             or subject to match.
  122.  
  123.       | or & (mandatory if multiple strings)
  124.             If  more  than  one string is specified, the set of
  125.             flags corresponding to each string  must  be  sepa-
  126.             rated by either an or operator `|' or an and opera-
  127.             tor `&'.  The and operator has a higher  precedence
  128.             than the or operator, e.g.  a complex match expres-
  129.             sion a|b&c|d will succeed if either of a, b&c, or d
  130.             matches.
  131.  
  132.       The string field in the entry is the name, subject or reg-
  133.       ular expression that will be matched against the  name  or
  134.       subject  of  each  article  in  the group (or all groups).
  135.       Colons and backslashes must be escaped with a backslash in
  136.       the string.
  137.